Learn R Programming

PerFit (version 1.2)

lz, lzstar: lz and lzstar person-fit statistics

Description

Compute the lz (Drasgow, Levine, and Williams, 1985) and the lzstar (Snijders, 2001) person-fit statistics.

Usage

lz(matrix, ip = NA, model = "2PL", ability = NA, method = "ML", mu = 0, sigma = 1)

lzstar(matrix, ip = NA, model = "2PL", method = "ML", mu = 0, sigma = 1)

Arguments

matrix
A data matrix of dichotomous item scores: Persons as rows, items as columns, item scores are either 0 or 1, no missing data.
ip
Matrix with previously estimated item parameters: One row per item, and three columns ([,1] item discrimination; [,2] item difficulty; [,3] lower-asymptote, also referred to as pseudo-guessing parameter). In case no item parameters are available th
model
Specify the IRT model to use in order to estimate the item parameters (only if ip=NA). The options available are "1PL", "2PL" (default), and "3PL".
ability
Vector with previoulsy estimated latent ability parameters, one per respondent, following the order of the row index of matrix. In case no ability parameters are available then ability=NA.
method
Specify the method to use in order to estimate the latent ability parameters (only if ability=NA for lz). The options available are "ML" (default), "BM", and "WL".
mu
Mean of the apriori distribution. Only used when method="BM". Default is 0.
sigma
Standard deviation of the apriori distribution. Only used when method="BM". Default is 1.

Value

  • An object of class "PerFit", which is a list with elements:
  • PFscoresA vector of length $N$ (number of respondents) with the values of the person-fit statistic.
  • PFstatisticThe name of the person-fit statistic used.

Details

Drasgow et al. (1985) introduced one of the most used person-fit statistics, lz. This statistic is the standardized log-likelihood of the respondent's response vector. lz is (supposed to be) asymptotically standard normally distributed. The computation of lz requires that both item and ability parameters are available. Function lz allows to user to enter his/her own item and ability parameter estimates (variables ip and ability, respectively). Alternatively, lz relies on functions available through the irtoys package for estimating the parameters. Specifically, the user can choose one from three possible IRT models to fit the data: model="1PL", model="2PL", or model="3PL". As for estimating the ability parameters there are three possible methods: method="ML" (maximum likelihood), method="BM" (Bayes modal), or method="WL" (weighted likelihood). It was later observed by several researchers (e.g., Molenaar and Hoijtink, 1990) that the asymptotic approximation only holds when true ability values are used. This limitation was overcome by Snijders (2001), who further developed lz into the lzstar statistic. An accessible paper that thoroughly explains the basic principles behind lzstar is Magis, Raiche, and Beland (2012). It is important to realize that not all item and/or ability estimation procedures can be used when computing lzstar. In particular, the estimation of the ability parameters is constrained (see Snijders, 2001, Equation 5). The lzstar algorithm internally estimates the ability parameters accordingly for one of three possible methods: method="ML" (maximum likelihood), method="BM" (Bayes modal), or method="WL" (weighted likelihood), see Magis et al. (2012). Aberrant response behavior is (potentially) indicated by small values of lz/lzstar (i.e., in the left tail of the sampling distribution).

References

Drasgow, F., Levine, M. V., and Williams, E. A. (1985) Appropriateness measurement with polychotomous item response models and standardized indices. British Journal of Mathematical and Statistical Psychology, 38(1), 67--86. Karabatsos, G. (2003) Comparing the Aberrant Response Detection Performance of Thirty-Six Person-Fit Statistics. Applied Measurement In Education, 16(4), 277--298. Magis, D., Raiche, G., and Beland, S. (2012) A didactic presentation of Snijders's l[sub]z[/sub] index of person fit with emphasis on response model selection and ability estimation. Journal of Educational and Behavioral Statistics, 37(1), 57--81. Meijer, R. R., and Sijtsma, K. (2001) Methodology review: Evaluating person fit. Applied Psychological Measurement, 25(2), 107--135. Molenaar, I. W., and Hoijtink, H. (1990) The many null distributions of person fit indices. Psychometrika, 55(1), 75--106. Snijders, T. B. (2001) Asymptotic null distribution of person fit statistics with estimated person parameter. Psychometrika, 66(3), 331--342.

See Also

lzpoly

Examples

Run this code
# Load the inadequacy scale data (dichotomous item scores):
data(InadequacyData);

# Compute the lz scores using a subsample of the first 200 response vectors:
lz(InadequacyData[1:200,]);

# Compute the lzstar scores using a subsample of the first 200 response vectors:
lzstar(InadequacyData[1:200,]);

Run the code above in your browser using DataLab